home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / UTILREEN / TXT2PS.LZH / POST.DOC < prev    next >
Text File  |  1992-01-23  |  16KB  |  463 lines

  1.  
  2.  
  3.  
  4.  
  5.                                 POST 1.2
  6.  
  7.  
  8.  
  9.     Introduction:  This document describes the MS-DOS utility POST.
  10.     POST is a utility that gives MS-DOS based PC's the ability to
  11.     print directly to PostScript printers from the DOS prompt.  This
  12.     information applies to version 1.2 of the POST utility.
  13.  
  14.     Background:  The first PostScript based printer was introduced by
  15.     Apple Computer.  This printer helped establish the desktop
  16.     publishing industry because it incorporated PostScript, the
  17.     sophisticated Page Description Language (PDL), developed by
  18.     Adobe.  The printer was designed to work with the Apple Macintosh
  19.     using an Apple developed interface called AppleTalk.  The printer
  20.     designers did however include an RS-232 port so that it could be
  21.     connected to other computers such as the IBM-PC and clones.
  22.     Software developers soon discovered the power of PostScript and
  23.     began to write printer drivers for PC application programs.  One
  24.     serious drawback however, is the lack of a PostScript driver for
  25.     MS-DOS.  The POST utility is an attempt to solve this oversight.
  26.  
  27.     Purpose:  POST allows users of PC's to print ASCII files directly
  28.     to PostScript printers.  It is intended to provide PostScript
  29.     support for programs that do not have the necessary drivers, and
  30.     to allow direct printing of DOS files.  POST allows directory
  31.     listings to be piped through it directly to a PostScript printer.
  32.     POST also allows the user to print files that have been created
  33.     by spreadsheet and database programs that can print to ASCII
  34.     files.
  35.  
  36.     This new release has been upgraded to allow the user to control
  37.     the printing parameters such as top, bottom, left margins and
  38.     font style, size and leading.  Options for scaling, rotating and
  39.     translation are also provided.
  40.  
  41.     Function:  POST Reads data from the standard input device,
  42.     converts it to PostScript format, then writes the data to the
  43.     standard output device.
  44.  
  45.     Command Line Format:  (options are explained on next pages)
  46.  
  47.          [d:][path]POST[option 1 value(s) ... option n value(s)]
  48.  
  49.     Upper or lower case is OK except for Font names (this will be
  50.     explained later).  There are 72 points per inch.  The default
  51.     page origin is located at the lower left corner with positive X
  52.     to the right and positive Y upwards.
  53.  
  54.     The output filename must be different from the input filename.
  55.     POST will space to the next column position if it finds a tab
  56.     character.  Column positions can be defined as preset distances
  57.     from the left margin.  POST will skip to top of form if it finds
  58.     a form feed character. POST will ignore control characters other
  59.     than line feed, form feed and tab.
  60.  
  61.  
  62.  
  63.                                     1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.                                 POST 1.2
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.     OPTIONS:         LETTER:    VALUE(S):                          DEFAULTS:
  79.  
  80.     Left Margin         L       Left margin in points              L 54
  81.     Top Print Line      T       Top print position in points       T 720
  82.     Bottom Print        B       Bottom print limit in points       B 54
  83.     Column Tab          C       Column tab spacing in points       C 56
  84.     Typeface Size       P       Typeface size in points            P 12
  85.     Leading             D       Vertical line spacing in points    D 12
  86.     Typeface Font       F       Selected font for printing         F Courier
  87.     Scaling             S       X and Y scaling multipliers        S 1.0 1.0
  88.     Page Origin         X       X and Y page translation points    X 0 0
  89.     Page Orientation    R       Page rotation angle in degrees     R 0
  90.  
  91.  
  92.     Details of Options:
  93.  
  94.     L:   The left margin is the value assigned in points (72 per inch) to
  95.          the leftmost printing position on the page.  For instance, if you
  96.          want to start printing one inch from the left side of the page you
  97.          would include the option - L 72.
  98.  
  99.     T:   The top margin is used by the printer every time a new page is
  100.          started. Its value is the number of points (72 per inch) from the
  101.          bottom of the page to the beginning character position of the first
  102.          line on the page.  Remember that if you decide to print in the
  103.          landscape mode, you will have a smaller number of points to the
  104.          first line.  POST uses 720 points as the first line default (10
  105.          inches times 72 points per inch).
  106.  
  107.     B:   The bottom margin is used by the printer to decide when to start a
  108.          new page.  Every time a new line is started the amount of
  109.          line-to-line space defined (see D - leading) is subtracted from the
  110.          current position on the page to see if enough room is available.
  111.          If not, the current page is printed and printing starts at the top
  112.          of a new page.  If you are using embedded form feed control, be
  113.          sure to set the bottom margin to a value that will keep from
  114.          automatically paging before you want to.  Also, most PostScript
  115.          printers cannot print closer than one fourth to one half inch of
  116.          the edge of the paper.
  117.  
  118.     C:   The column tab spacing is the increment in points to be added to
  119.          the left margin for each tab column across the page.  The default
  120.          tab column for the first tab is 54 points for the left margin plus
  121.          56 points.  The next tab column is 56 points more than the first.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                     2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.                                 POST 1.2
  138.  
  139.  
  140.  
  141.     P:   One advantage of PostScript printers is that they can print
  142.          characters in any size desired because they are defined in a manner
  143.          that allows them to be scaled very accurately.  POST allows any
  144.          integer value to be used.  The default size is 12 points which is
  145.          10 characters per inch.  Do not forget that the line-to-line
  146.          spacing must be adjusted in conjunction with the typeface size or
  147.          overprinting can result.  Normally the line-to-line (leading -
  148.          option D) spacing should be equal to or greater than the typeface
  149.          size.
  150.  
  151.     D:   Leading is the line-to-line spacing value.  The name is derived
  152.          from when type was made from the metal of the same name - lead.
  153.          The lead was poured to make rows of letters and the space between
  154.          rows was the amount of leading.  Be sure to increase the leading
  155.          when you increase the type size to avoid overprinting.  The leading
  156.          value is also used to determine the number of lines per page by
  157.          subtracting its value from the calculated line position each time a
  158.          new line is started.
  159.  
  160.     F:   The default font is Courier.  Any other font that is already in the
  161.          PostScript printer can be used.  Be sure to use upper and lower
  162.          case as described by the printer manual.  Examples for Courier are:
  163.          Courier, Courier-Bold, Courier-Oblique and Courier-BoldOblique.  If
  164.          you have downloaded a special font, you can select it.  The
  165.          PostScript printer will ignore requests for incorrectly identified
  166.          fonts.  Please remember that most of the fonts other than Courier
  167.          are proportional and that column data may not line up properly.
  168.          Examples other than Courier are not shown because most of the fonts
  169.          are copyrighted.
  170.  
  171.     S:   Scaling is done by the PostScript printer.  It multiplies each X
  172.          and Y coordinate by the X and Y scaling factors that you have
  173.          provided.  The printout can be enlarged or reduced.  The X and Y
  174.          scaling factors are the only ones that POST allows to be
  175.          non-integers.  POST sends scaling, then translation and finally
  176.          orientation values sequentially to the printer.
  177.  
  178.     X:   Page Origin:  This will allow you to translate the page origin to
  179.          any place on the page.  The values specified must be in points.
  180.          Remember that if you translate the origin, X and Y positive values
  181.          are still up and to the right.  If you translate the X coordinate
  182.          of the origin to the top of the page, nothing will print because it
  183.          will be off the page!  Also, any characters that extend beyond the
  184.          right edge of the page will also not print.  Generally if you
  185.          translate the page origin you also need change the orientation of
  186.          the page with the Rotate command (option R).
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                     3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.                                 POST 1.2
  204.  
  205.  
  206.  
  207.     R:   Rotation of the coordinate system can be very confusing.  The
  208.          PostScript printer rotates the page image counter-clockwise by the
  209.          number of degrees requested.  POST expects the number to be an
  210.          integer - i.e. one degree increments.  POST sends the rotation
  211.          value after it sends the scaling and translation values.  See the
  212.          example of landscape page orientation for an example and experiment
  213.          using variations.
  214.  
  215.  
  216.  
  217.  
  218.  
  219.     Examples: The following performs a standard directory function, pipes
  220.               the output as a standard input to POST and POST converts the
  221.               directory listing to PostScript format and sends it to the
  222.               PostScript printer:
  223.  
  224.               C>DIR | POST > PRN
  225.  
  226.  
  227.               The following sends the file infile.ext to POST, POST converts
  228.               it to PostScript format and sends it to the file outfile.ext:
  229.  
  230.               C>POST < infile.ext > outfile.ext
  231.  
  232.               The following prints a page in the landscape mode by setting
  233.               the top of page at 540 points, translating the origin to the
  234.               upper left corner and rotating the page counter-clockwise 270
  235.               degrees:
  236.  
  237.               C>POST T 540 X 0 792 R 270 < infile.ext > PRN
  238.  
  239.               The following prints very full pages by setting the left
  240.               margin to 24 points, top of page to 756 points and the bottom
  241.               of page to 24 points:
  242.  
  243.               C>POST l 24 t 756 b 24 < infile.ext > PRN
  244.  
  245.     Hint:     If there are specific functions that you are going to use
  246.               often, create batch files with the required options.  See your
  247.               DOS manual for more information about creating batch files.
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                     4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.                                 POST 1.2
  270.  
  271.  
  272.  
  273.     Computer Connections:
  274.  
  275.     The purpose of this section is to help you establish the correct
  276.     connection and communication method between your computer and PostScript
  277.     printer.
  278.  
  279.     POST was developed for people who have a PC (or clone) with a PostScript
  280.     printer connected to the parallel port of their PC.  That is why the
  281.     examples are using "PRN" as the output device.  If you have this
  282.     configuration, you should have no trouble using the POST utility.
  283.  
  284.     Making the PostScript printer work with a serial connection is slightly
  285.     more difficult.  The printer and the PC must be set to communicate at
  286.     the same speed.  9600 bits-per-second must be used on the LaserWriter.
  287.     To set up DOS to communicate correctly, enter the following incantation
  288.     at the DOS prompt.  Substitute the correct COM port if yours is
  289.     different.
  290.  
  291.               MODE COM1:9600,N,8,1,P
  292.  
  293.     This tells DOS to talk to serial device COM1 at 9600 bits-per-second,
  294.     with no parity, eight data bits, one stop bit and to continuously retry
  295.     to send upon receipt of time out errors from the asynchronous adapter.
  296.  
  297.     You may also want to enter the following:
  298.  
  299.               MODE LPT1:=COM1:
  300.  
  301.     This tells DOS to re-route information intended for the parallel port to
  302.     the specified serial port.  You may not need this.
  303.  
  304.     Next set your printer to use the serial port at 9600 bits per second
  305.     (see your printer manual).
  306.  
  307.     There is one problem that frequently occurs when a PostScript printer is
  308.     attached to a PC via the serial ports on both devices.  The problem
  309.     occurs because the default handshaking (or synchronization) method used
  310.     by the devices are different.  By default, the Laserwriter and other
  311.     PostScript printers use XON/XOFF (software) handshaking.  The PC, on the
  312.     other hand, uses DSR/DTR (hardware) handshaking.  The problem is
  313.     exacerbated by the fact that many application programs for the PC
  314.     control the serial port directly and implement the software handshake
  315.     protocol.  This means that your word processor could produce perfect
  316.     documents, but the POST utility would not work from the DOS prompt.
  317.  
  318.     In order to solve this problem, a couple of options are available.
  319.     The first is to change the default handshaking method of the printer,
  320.     and the second is to change the default handshaking method of the PC.
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                     5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.                                 POST 1.2
  336.  
  337.  
  338.  
  339.     To change the default handshaking method of the printer, you send a
  340.     small PostScript program to it.  On some printers (such as the NT and
  341.     the NTX) you can also change it via the DIP switches.  Early versions of
  342.     the Laserwriter will not allow you to change the default handshaking
  343.     method.  If you change the default handshaking method of the printer, a
  344.     correctly wired cable is essential.  The PostScript program is shown
  345.     below.  Copy it to the printer using the DOS COPY command.
  346.  
  347.  
  348.  
  349.  
  350.     0000 % Server Password (zeros, not oh's)
  351.     statusdict begin 25 sccbatch 4 ne exch 9600 ne or {serverdict begin
  352.     exitserver}{pop end stop}ifelse statusdict  begin
  353.     25  9600  4  setsccbatch
  354.     end
  355.  
  356.  
  357.  
  358.     Create the file listed above using EDLIN or a wordprocessor that can
  359.     create a simple ASCII file.  Embed a control D as the last character to
  360.     tell the printer that this is the end of the data.  (Most MS-DOS based
  361.     word processors and text editors support the default method of holding
  362.     down the ALT key and entering the decimal value of the required control
  363.     character on the keypad.  To enter a control D hold down the ALT key and
  364.     enter 004 on the keypad.  To enter a control character with EDLIN, type
  365.     Ctrl-V, then press the Capital D.)  This program makes a semi-permanent
  366.     change to the printer.  That is - it will stay in DSR/DTR protocol until
  367.     you change it again.  To switch back to XON/XOFF change the two "4"s to
  368.     "0"s (zeros, not oh's).
  369.  
  370.     To change the default handshaking method of the PC, you may need to use
  371.     a copy of the program XONXOFF.COM included in the ARC file.  This program
  372.     is a TSR which means it does not go away until you turn off the
  373.     computer.  XONXOFF.COM works only with COM1.  Some PC clones allow you to
  374.     specify the handshaking mode of the serial ports.  If yours does, you 
  375.     should have no trouble once you set it for XON/XOFF.
  376.  
  377.     NOTE:
  378.  
  379.     If you have been using POST.COM (the previous version of this utility)
  380.     you will need to remove it from the directory when you install POST.EXE.
  381.     Otherwise, DOS will execute the old version.  DOS always executes the
  382.     file with the .COM extension if it exits even if you type in the .EXE
  383.     extension.
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                     6
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.                                 POST 1.2
  402.  
  403.  
  404.  
  405.  
  406.                            A D V E R T I S E M E N T
  407.  
  408.     Shareware:      This program is distributed as Shareware.  If you
  409.                     find this program useful, send $5.00 to:
  410.  
  411.  
  412.                             F. C. Betts
  413.                             Veda Incorporated
  414.                             Suite 200
  415.                             5200 Springfield Pike
  416.                             Dayton, OH 45431
  417.  
  418.             Any comments and/or suggestions will be appreciated and a
  419.             response will be sent if possible.
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                     7
  460.  
  461.  
  462.  
  463.